OLA 文档中心

主题

2026-06-30

按单键设置OCR模型推理配置 - OcrSetModelConfigByKey ​

函数简介 ​

按 单个键 对已加载 OCR 模型合并更新推理调参，行为等价于 OcrSetModelConfig({"key": value})。键名大小写不敏感，布尔/数值可传字符串。

接口名称 ​

OcrSetModelConfigByKey

DLL 调用 ​

int OcrSetModelConfigByKey(long ola, long modelHandle, string key, string value);

参数说明 ​

参数名类型说明
ola长整数型OLAPlug 对象指针。
modelHandle长整数型模型句柄；内置 mobile 为 0。
key字符串配置项名称（PascalCase，大小写不敏感，见 OCR模型配置说明）。
value字符串配置项值；布尔可传 true/false/1/0/yes/no。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int ret = ola.OcrSetModelConfigByKey(0, "username", "true");
if (ret == 1) {
    // 操作成功
}
csharp
using OLAPlug;

var ola = new OLAPlugServer();
int ret = ola.OcrSetModelConfigByKey(0, "username", "true");
if (ret == 1)
{
    // 操作成功
}
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
ret = ola.OcrSetModelConfigByKey(0, "username", "true")
if ret == 1:
    pass  # 操作成功
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
int ret = ola.OcrSetModelConfigByKey(0, "username", "true");
if (ret == 1) {
    // 操作成功
}
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
ret := ola.OcrSetModelConfigByKey(0, "username", "true")
if ret == 1 {
    // 操作成功
}
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let ret = ola.ocr_set_model_config_by_key(0, "username", "true");
if ret == 1 {
    // 操作成功
}
cpp
var ola = com("OlaPlug.OlaSoft")
var ret = ola.OcrSetModelConfigByKey(0, "username", "true")
if(ret == 1) {
    // 操作成功
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
ret = ola.OcrSetModelConfigByKey(0, "username", "true")
If ret = 1 Then
    ' 操作成功
End If
text
.局部变量 ola, OLAPlug
ola.创建 ()
ret ＝ ola.OcrSetModelConfigByKey(0, “username”, “true”)
.如果真 (ret ＝ 1)
    ' 操作成功
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var ret = ola.OcrSetModelConfigByKey(0, "username", "true");
if(ret == 1){
    // 操作成功
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
整数 ret = ola.OcrSetModelConfigByKey(0, "username", "true")
如果真 (ret ＝ 1)
{
    // 操作成功
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int32_t ret = ola.OcrSetModelConfigByKey(0, "username", "true");
if (ret == 1) {
    // 操作成功
}

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
OcrSetModelConfigByKey(instance, 0, "username", "true");
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int OcrSetModelConfigByKey(long ola, long modelHandle, string key, string value);

long instance = CreateCOLAPlugInterFace();
OcrSetModelConfigByKey(instance, 0, "username", "true");
python
from ctypes import CDLL, c_int, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
ola.OcrSetModelConfigByKey(instance, 0, "username", "true")

返回值 ​

返回值说明
（返回值）整数型：1 成功；0 失败（句柄无效、键名无效、值类型错误或重初始化失败）。

注意事项 ​

项目说明
字段说明见 [OCR模型配置说明](OCR模型配字段说明见 OCR模型配置说明；JSON 解析规则见 JSON配置解析约定。
与 [OcrSetModelConfig](设置与 OcrSetModelConfig 共用同一套字段与后端重建逻辑。
路径不支持修改模型路径、密码、BackendId 等加载期参数。